home *** CD-ROM | disk | FTP | other *** search
/ Total Network Tools 2002 / NextStepPublishing-TotalNetworkTools2002-Win95.iso / Archive / IP Address Tools / WinIPDO.EXE / readme.txt next >
Text File  |  1999-11-24  |  7KB  |  173 lines
  1.      WinIPDO v2.1
  2.      Jason Hughes
  3. Flare Development Group
  4.     Copyright 1999
  5.  
  6. Contents
  7.  
  8. 1. Description
  9. 2. Usage
  10. 3. What is it good for?
  11. 4. Terms of Usage
  12. 5. Release History
  13.  
  14. ----------------------------
  15.  
  16. DESCRIPTION
  17.  
  18. WinIPDO is a radical departure from most automation tools.
  19. WinIPDO monitors all the network IP addresses in a machine for changes 
  20. on 10 second intervals.  If any changes occur, WinIPDO automatically 
  21. writes the new IP address to a text file, then executes a command 
  22. you specified for that particular event.
  23.  
  24. There are four events:
  25.   Any IP goes online.
  26.   Any IP goes offline.
  27.  
  28. All IP numbers are written as dotted-four notation in the "ip.txt" file.
  29.  
  30. Events can be active or inactive.  Events may have indpendent commands.  
  31. Your settings are stored in the registry so you don't have to type them 
  32. in again.  However, you can change them very easily by selecting 
  33. "Settings..." on the popup menu.  Also, users with multiple IPs can set 
  34. WinIPDO to ignore one hierarchy (192 means ignore all 192.xxx.xxx.xxx),
  35. so the commands will not launch when an IP in that range changes.
  36.  
  37. ----------------------------
  38.  
  39. USAGE
  40.  
  41. C:\>winipdo.exe
  42.  
  43. After starting up, a little blue "IP" icon should show up on your 
  44. system tray.  Click there to show WinIPDO's menu.
  45.  
  46. Just before launching the specified command, WinIPDO writes out the
  47. ip address to a text file into the current directory, called "ip.txt".
  48.  
  49. On the context popup menu there are several options:
  50. About...................Shows my email, URL, and other misc info.
  51. Settings................Edit and de/activate commands.
  52. Show Console............Pops up a dos console output logging window
  53.                         which contains historical information since being run.
  54. Hide Console............Removes the logging window.
  55. Test Connection.........Manually launch the connection command.
  56. Test Disconnection......Manually launch the disconnection command.
  57. Exit....................Asks for verification, then closes out WinIPDO.
  58.  
  59. ----------------------------
  60.  
  61. WHAT IS IT GOOD FOR?
  62.  
  63. + Among other things, WinIPDO makes it easy to cause a dynamic IP 
  64. address-bound machine to appear to have a static IP if you run 
  65. a remote web site by automating an FTP script to upload a new 
  66. IP address in a file.
  67.  
  68. + If nothing else, it's useful for people who would like to launch
  69. a series of utilities or applications in a batch file locally
  70. when going on or off line, like a web browser or mail program.
  71.  
  72. Anything you can think of, relating to getting online or offline, can 
  73. be automated using WinIPDO.  
  74.  
  75. ----------------------------
  76.  
  77. NOTES
  78.  
  79. + WinIPDO considers starting the program the same as making an initial
  80. connection to external IP addresses.  This helps facilitate hands-off
  81. automation straight from booting up.
  82.  
  83. + Be aware that the directory from which WinIPDO is started is the 
  84. directory used as the root for relative paths.  In my shortcuts, I
  85. always give it an initial location.
  86.  
  87. + New in v2.0 is required Winsock 2.0 TCP/IP stack.  The best way to
  88. get everything you need is to grab these files from Microsoft
  89. directly, and apply them in this order (Win9x):
  90.         y2kvdhcp.exe
  91.         w95ws2setup.exe
  92.         vtcpup20.exe
  93.  
  94. + As a side effect of keeping open the Logging window, any output
  95. your command causes will go to that window.  If at any time the logging
  96. window is closed, that output is cleared even though the historical
  97. data is preserved.  This is either a bug or a feature, depending on
  98. your perspective.  Leave the console open for maximum information, closed
  99. for minimum interference with your tasks.
  100.  
  101. ----------------------------
  102.  
  103. TERMS OF USAGE
  104.  
  105. This is PostcardWare.  This software is NOT free.  If you use WinIPDO, 
  106. or even if you don't use it but keep it on your machine more than 30
  107. days, or even hate it enough to want to let me know, send FlareDev a 
  108. postcard from wherever you are to:
  109.  
  110.                 4106 Adelphi Lane
  111.                 Austin, TX 78727
  112.  
  113. Non-commercial users, besides the above meager tithe, are welcome 
  114. to use WinIPDO in any way they see fit.  I guarantee nothing, except 
  115. that I will not support it or be liable for any damages caused by 
  116. any action or inaction of this product.  If it is causing problems 
  117. for you, don't use it.  All postcards and anything else mailed to
  118. FlareDev becomes the sole property of FlareDev upon receipt, and
  119. cannot be returned.
  120.  
  121. Commercial users should contact Flare Development Group directly 
  122. via email for licensing conditions.
  123.  
  124. PS-Donations accepted (I collect foreign currency), but be sure 
  125. to put them in an envelope.
  126.  
  127. ----------------------------
  128. RELEASE HISTORY
  129.  
  130. Nov-25-1999  v2.1
  131.   Upon testing and further reading, it becomes obvious that there is
  132. no way to uniquely identify each network adapter in the machine.  
  133. As I attempted the interface before, each network address had its 
  134. own start/stop commands.  The worst case was starting the app without 
  135. any network connections, then the first connection occurs.  
  136. Unfortunately, that single IP address could belong to any adapter
  137. and there's no right way to associate them.  A good guess might've
  138. been literally checking the distance formulate of the dotted-quad
  139. from the last known address.  But rather than hack up a good app,
  140. I made it work the way I thought would work best.  Anytime any 
  141. address goes online, the connection command triggers.  Most people 
  142. have at most 2 or 3 connections and want (or can tolerate) the 
  143. same happening for each connection.  I also added an ignore hierarchy
  144. mask to help filter out the LAN addresses that are static, so startup
  145. (and occasionally DHCP renegotiation) inside a network is invisible.
  146.  
  147. Nov-24-1999  v2.0
  148.   After all night banging through library code, I realized Winsock
  149. stinks.  WinIPDO v1.0 had the fatal flaw of munching through memory
  150. at a steady rate due to a memory leak in gethostbyname().  It was
  151. only noticeable on a server with 32 megs of ram and very limited
  152. drive space for swapping, and since WinIPDO pings every 10 seconds,
  153. Win9x can't task switch anything out of ram to disk after a certain
  154. point.  Even on that small machine, it took over 10 days to get to
  155. 20mb of ram usage.  The crux is, if you're running older Winsock
  156. versions on your machine (some programs do require it), that's not so
  157. good.  Get the update to run WinIPDO.  If you can't upgrade, I'm
  158. sorry, but I refuse to compromise a machine's stability with our
  159. software intentionally.
  160.  
  161. Sep-14-1999  v1.0
  162.   First revision is complete.  It wasn't much effort to get something
  163. working, but there's lots of features lacking.  Plenty of user
  164. requests for them too.
  165.  
  166. ----------------------------
  167.  
  168. Jason Hughes
  169. Flare Development Group
  170. panther@flaredev.com
  171. http://www.flaredev.com/
  172.  
  173.